home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / amiutils / m_p / photocdaga / doc / photocdaga.dok < prev    next >
Text File  |  1995-12-30  |  13KB  |  372 lines
  1.                     PhotoCDAGA 1.1 von Gⁿnther R÷hrich
  2.                     **********************************
  3.  
  4.  
  5. PhotoCDAGA ist ein Anzeigeprogramm/Konverter fⁿr Bilder im PhotoCD Format. Es
  6. basiert auf den Quelltexten zu dem Programm "hpcdtoppm" geschrieben von Hadmut
  7. Danisch. Aus disem Grund mu▀ ich auf seinen Copyright-Vermerk aufmerksam
  8. machen:
  9.  
  10.    hpcdtoppm (Hadmut's pcdtoppm) v0.6
  11.    Copyright (c) 1992, 1993, 1994 by Hadmut Danisch (danisch@ira.uka.de).
  12.    Permission to use and distribute this software and its
  13.    documentation for noncommercial use and without fee is hereby granted,
  14.    provided that the above copyright notice appear in all copies and that
  15.    both that copyright notice and this permission notice appear in
  16.    supporting documentation. It is not allowed to sell this software in 
  17.    any way. This software is not public domain.
  18.  
  19. Diese Auflagen gelten also auch fⁿr PhotoCDAGA. Aber keine Angst, Du kannst es
  20. nach Belieben weitergeben oder verΣndern. Lediglich die kommerzielle Nutzung
  21. oder Vertrieb des Programmes ist nicht gestattet. (Gegen eine Verbreitung auf
  22. CD-ROM wie der Aminet CD dⁿrfte ebenfalls niemand etwas dagegen haben.) Im
  23. Zweifelsfall sollte man direkt bei Hadmut Danisch nachfragen. (Adresse siehe
  24. unten.)
  25.  
  26. Wie schon der Name sagt ist zur Nutzung des Programms ein Amiga mit dem AGA-
  27. Chipsatz erforderlich. Au▀erdem ein 68020 oder h÷herer Prozessor, reichlich
  28. Speicher sowie ein CD-ROM Laufwerk, das auch Photo-CDs lesen kann.
  29. Die Farbanzeige erfolgt im HAM8-Modus, die Graustufenanzeige im 256-Farben-
  30. Modus.
  31.  
  32. Die Vorteile von PhotoCDAGA:
  33.  
  34. - es kostet nichts (der wohl gr÷▀te Vorteil...)
  35. - vollstΣndiger Quelltext ist verfⁿgbar, kann mit allen C-Compilern auf dem
  36.   Amiga ⁿbersetzt werden
  37. - hohe Geschwindigkeit (wurde mit gcc 2.6.3 kompiliert, ein Teil ist direkt
  38.   in Assembler geschrieben)
  39. - hohe BildqualitΣt bei Verwendung von map-Dateien und des overskip-Modus
  40.   (wahrscheinlich besser als mit allen bisherigen Programmen)
  41. - abspeichern im ppm-Format m÷glich zur anschlie▀enden Konvertierung in
  42.   andere Bildformate
  43.   (z.B ins IFF-ILBM Format mit ppm2AGA oder nach JPEG mit cjpeg)
  44.   Im NETPBM-Paket sind Konverter fⁿr (fast) alle Bildformate vorhanden.
  45.   (Aminet: gfx/pbm)
  46.  
  47. Nachteile (leider):
  48.  
  49. - hoher Speicherverbrauch
  50. - schlechter Komfort (nur Shell-Bedienung)
  51. - keine Unterstⁿtzung h÷herer Aufl÷sungen als Base (512x768)
  52.   (hier mu▀ man auf hpcdtoppm, das Original, zurⁿckgreifen)
  53.  
  54. An dieser Stelle noch ein gro▀es Dankesch÷n an Hadmut Danisch fⁿr sein
  55. Programm hpcdtoppm und den zugeh÷rigen Quelltext. Ohne seine Arbeit gΣbe
  56. es auch PhotoCDAGA nicht.
  57.  
  58. Vielen Dank noch an alle die an dem GNU C-Compiler mitgewirkt haben.
  59.  
  60. ***********************************************************************
  61.  
  62. So, nun geht es endlich mit der Anleitung los:
  63.  
  64. Systemvoraussetzungen:
  65.  
  66. Ein Amiga mit viel Speicher und:
  67.  
  68. - AGA Chipsatz
  69. - 68020 oder h÷heren Prozessor
  70. - OS 3.0 oder h÷her
  71. - ein CD-ROM Laufwerk zum Lesen der Photo-CDs
  72.  
  73. Im Gegensatz zur Version 1.0 ist die ixemul.library nicht mehr erforderlich
  74. und ein Stapelspeicher (Stack) von 4000 Bytes genⁿgt jetzt auch.
  75.  
  76. Als Eingabe braucht man noch Bilder im Photo-CD Format. Diese haben die Endung
  77. .PCD und sind auf den Photo-CDs im Verzeichnis PHOTO_CD/IMAGES zu finden.
  78. (Gilt auch fⁿr fertig bespielte CDs die eventuell noch PC-Programme enthalten.)
  79. Fⁿr die ▄bersicht (Option -0) ist eine sog. Overview-Datei erforderlich.
  80. (ⁿblicher Dateiname: PHOTO_CD/OVERVIEW.PCD)
  81.  
  82.  
  83. Installation:
  84. *************
  85.  
  86. Die Programme aus dem bin-Verzeichnis k÷nnen in ein beliebiges Verzeichnis
  87. kopiert werden, sie sollten sich aber im Suchpfad der Shell befinden. 
  88.  
  89. Fⁿr die Verwendung des Shell-Skripts PhotoMap mu▀ JPEGTMP: mit einem assign-
  90. Befehl an ein Verzeichnis auf einer Festplatte mit ausreichend Speicherplatz
  91. zugewiesen werden. (z.B. assign JPEGTMP: HD:T) Dieses Verzeichnis wird auch
  92. bei der Erzeugung von map-Dateien fⁿr jpegAGA verwendet.
  93. Am Besten schreibt man diesen Befehl in die User-Startup Datei damit er nach
  94. jedem Neustart ausgefⁿhrt wird.
  95.  
  96. Das Shell-Skript PhotoMap mu▀ in das S: Verzeichnis kopiert werden. Es setzt
  97. voraus da▀ sich die Programme PhotoCDAGA sowie ppm2AGA im Suchpfad der Shell
  98. befinden und da▀ ein JPEGTMP: Verzeichnis existiert. Eventuell mu▀ man noch die
  99. Umgebungsvariable MAPDIR setzen, siehe spΣter.
  100.  
  101.  
  102. Der Aufruf geschieht wie folgt:
  103. *******************************
  104.  
  105. PhotoCDAGA PhotoCD-Bildname [ppm-Bildname] Optionen
  106.  
  107.  
  108. PhotoCD-Bildname
  109. ****************
  110.  
  111. Das ist der Name einer Datei im PhotoCD-Format. (bzw. Overview-Datei)
  112. (z.B cd:PHOTO_CD/IMAGES/IMG0001.PCD)
  113. Wenn das Format nicht stimmt dann bekommt man nur Mⁿll angezeigt.
  114.  
  115. Achtung: Manche Bilder enthalten nicht alle Aufl÷sungen. (Wenn die Datei-
  116. lΣnge sehr viel kleiner als 3MB ist) Es kann sein da▀ man dann die -x
  117. Option bei der Base-Aufl÷sung nicht verwenden kann.
  118.  
  119.  
  120. ppm-Bildname
  121. ************
  122.  
  123. Name der zu erzeugenden ppm/pgm-Datei. (Nur n÷tig wenn die Option -pgm oder
  124. -ppm angegeben wurde.)
  125.  
  126.  
  127. Optionen
  128. ********
  129.  
  130. -b Name
  131.    Dieser Option mu▀ ein Name folgen. Damit wird verhindert da▀ bei mehreren
  132.    CDs die gleichen map-Dateien fⁿr verschiedene Bilder verwendet werden.
  133.    (s. spΣter) Beim Erzeugen der map-Dateien mit dem Shell-Skript PhotoMap ist
  134.    die gleiche Option dann anzugeben. Diese Option ist nur bei Farbanzeige
  135.    sinnvoll.
  136.  
  137. -x
  138.    Es wird der sog. overskip-Modus verwendet, der zu einer besseren Bild-
  139.    qualitΣt fⁿhrt. (nur bei Farbdarstellung.) Wird hierbei die Base-Aufl÷sung
  140.    verwendet dann dauert die Bearbeitung viel lΣnger und es ist sehr viel
  141.    Speicher n÷tig. (Mit 6MB ist es gerade noch m÷glich.)
  142.  
  143. -s
  144.    Die SchΣrfe des Bildes wird erh÷ht. Man sollte das aber nur bei wirklich
  145.    unscharfen Bildern einsetzen damit man mehr Details erkennen kann.
  146.  
  147. -c
  148.    Das Programm versucht eine eventuelle schwarze Berandung aus dem Bild zu
  149.    entfernen.
  150.  
  151. -n 
  152.    Das Bild wird nicht gedreht. Normalerweise versucht PhotoCDAGA die richtige
  153.    Orientierung selber herauszufinden (Hoch- oder Querformat) um das Bild
  154.    korrekt anzuzeigen.
  155.  
  156. -r
  157.    Das Bild wird im Uhrzeigersinn gedreht (d.h ins Hochformat gebracht)
  158.  
  159. -l 
  160.    Das Bild wird entgegen dem Uhrzeigersinn gedreht (d.h. ins Hochformat
  161.    gebracht)
  162.  
  163. -h 
  164.    Das Bild wird gekippt.
  165.  
  166. -m
  167.    Alle durchgefⁿhrten Schritte bei der Dekodierung werden auf dem Bildschirm
  168.    mitgeteilt.
  169.  
  170. -c-
  171.    Das Bild wird etwas dunkler angezeigt.
  172.  
  173. -c+
  174.    Das Bild wird etwas heller angezeigt.
  175.  
  176. -pgm
  177.  
  178.    Es wird eine pgm-Datei erzeugt. (d.h. 8bit-Graustufen-Format) Als zweiten
  179.    Parameter ist der Dateiname anzugeben.
  180.  
  181. -ppm
  182.    Es wird eine ppm-Datei erzeugt. (d.h. 24bit-Farbe) Als zweiten Parameter ist
  183.    der Dateiname anzugeben.
  184.  
  185. -gray
  186.    Die Anzeige erfolgt im Graustufen-Modus.
  187.  
  188. -vga
  189.    Bei der Anzeige wird der VGA-Bildschirmmodus verwendet. (Auch Multiscan
  190.    genannt.)
  191.  
  192. -0 n  (neu in Version 1.1)
  193.    Es wird eine ▄bersicht (16 Bilder) erzeugt, beginnend mit dem n-ten Bild.
  194.    Bei Graustufenanzeige (Option -gray) werden zusΣtzlich noch die jeweiligen
  195.    Bildnummern angezeigt. Die Eingabedatei mu▀ eine sog. Overview-Datei sein.
  196.    (ⁿblicherweise PHOTO_CD/OVERVIEW.PCD)
  197.  
  198. -1
  199.    Es wird die Base/16-Aufl÷sung (128x192) angezeigt.
  200.  
  201. -2
  202.    Es wird die Base/4-Aufl÷sung (256x348) angezeigt.
  203.  
  204. -3 
  205.    Es wird die Base-Aufl÷sung (512x768) angezeigt.
  206.    (Das ist die Voreinstellung.)
  207.  
  208.  
  209.  
  210. Ein vorzeitiger Abbruch ist mit CTRL-C m÷glich. Wird bereits ein Bild angezeigt
  211. dann mu▀ man die rechte Maustaste drⁿcken. Der Bildschirm hat eine (unsichtbare)
  212. Ziehleiste sowie Vordergrund/Hintergrund Schalter, die voll funktionsfΣhig sind.
  213. Dank der Autoscroll-Eigenschaft wird der Bildschirm automatisch verschoben wenn
  214. man mit dem Mauszeiger den Rand erreicht.
  215.  
  216. Will man ein PhotoCD-Bild in das normale IFF-ILBM Format umwandeln dann mu▀ man
  217. als erstes eine ppm-Datei erzeugen und anschlie▀end ppm2AGA aufrufen. NΣheres
  218. steht in der zugeh÷rigen Anleitung.
  219.  
  220.  
  221. Erzeugung der map-Dateien
  222. *************************
  223.  
  224. Diese Dateien sind unbedingt erforderlich damit die Anzeige in der best-
  225. m÷glichen QualitΣt erfolgt. Sie werden im Normalfall durch das Shell-Skript
  226. PhotoMap erzeugt, so da▀ man sich nicht um die Details kⁿmmern mu▀.
  227. Der Aufruf lautet:
  228.  
  229.  PhotoMap PhotoCD-Datei [-b BaseName]
  230.  
  231. Bei erfolgreicher Ausfⁿhrung wird eine map-Datei mit korrektem Namen erzeugt.
  232. (auch auf PC-Dateisystemen) Man kann auch mehrere Dateien mit einem Aufruf er-
  233. zeugen. So werden z.B. durch den Befehl
  234.  
  235.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD
  236.  
  237. alle Bilder auf einer PhotoCD bearbeitet.
  238.  
  239. Falls es nicht m÷glich ist, die map-Datei an der gleichen Stelle wie das Bild
  240. abzuspeichern (das ist bei CD-ROMs immer der Fall) dann wird die map-Datei in
  241. dem Verzeichnis abgelegt, auf das die Umgebungsvariable MAPDIR weist. PhotoCDAGA
  242. wird sie dann ebenfalls dort suchen.
  243. Das Setzen der Umgebungsvariablen kann z.B. erfolgen mit dem Befehl:
  244.  
  245.  setenv MAPDIR HD:tempdir
  246.  
  247. Die Variable geht dann allerdings nach einem Zurⁿcksetzen des Rechners verlo-
  248. ren. Man kann sie dauerhaft sichern mit dem Befehl:
  249.  
  250.  copy ENV:MAPDIR ENVARC:
  251.  
  252.  
  253. ACHTUNG: Auf keinen Fall darf man diselbe map-Datei fⁿr mehrere verschiedene
  254. Bilder verwenden, das fⁿhrt zu einer Verschlechterung der QualitΣt. Wenn man
  255. mehrere PhotoCD's hat dann sollte man unbedingt mit der Option -b einen ver-
  256. schiedenen Basisnamen fⁿr jede CD angeben. Die Option ist fⁿr das Skript
  257. PhotoMap und fⁿr PhotoCDAGA anzugeben.
  258.  
  259. Wenn man z.B. eine CD mit Bilder aus Australien hat dann erzeugt man die map-
  260. Dateien mit dem Befehl: 
  261.  
  262.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD -b Australien
  263.  
  264. (Die Umgebungsvariable MAPDIR mu▀ auch gesetzt sein!)
  265.  
  266. Anschlie▀end kann man die Bilder anschauen mit:
  267.  
  268.  PhotoCDAGA cd:PHOTO_CD/IMAGES/IMG0030.PCD -c -vga -b Australien
  269.  
  270. (Wenn genⁿgend Speicher vorhanden ist sollte man noch -x angeben.)
  271.  
  272.  
  273. Nun kommen wie ⁿblich vorab ein paar Fragen und Antworten:
  274. **********************************************************
  275.  
  276. (das erspart mir spΣter die Arbeit)
  277.  
  278. F: Ich habe 6MB Speicher aber ich kann die Optione -x in der Base-Aufl÷sung
  279.    wegen Speichermangel nicht einsetzen.
  280.  
  281. A: Das ist gut m÷glich. Es empfiehlt sich, den Rechner ohne die Startup-Sequence
  282.    zu booten (d.h. man kommt direkt in die Shell) und es von dort aus zu
  283.    versuchen. (nur fⁿr Freaks...) Einige Tips:
  284.     - setpatch aufrufen
  285.     - das CD-ROM Laufwerk anmelden mit z.B. mount CD:
  286.     - assign ENV: RAM:, setenv MAPDIR xxx eingeben
  287.     - nun mⁿ▀te es gehen
  288.     (eventuell vorher noch den Multiscan-Monitortreiber starten)
  289.  
  290.  
  291. F: Ich habe ein CD-ROM Laufwerk x und den Kontroller y, warum kann ich die
  292.    Photo-CDs nicht lesen ?
  293.  
  294. A: Das wei▀ ich leider auch nicht. Es empfiehlt sich auf jeden Fall, es mit
  295.    dem frei erhΣltlichen AmiCDROM-Dateisystem noch zu versuchen.
  296.  
  297.  
  298. Bei sonstigen Fehlern/Wⁿnsche/VerbesserungsvorschlΣge bitte ich darum, mich
  299. zu benachrichtigen. Und nicht vergessen: Bei Fehlerbeschreibungen immer die
  300. verwendete Konfiguration angeben. (wie unten)
  301.  
  302. Getestete Konfiguration: (meine)
  303.  
  304. Amiga 4000/030, OS 3.0, 2MB Chip, 4MB Fast
  305. Prozesor: 68EC030/25MHz, Koprozessor: 68882/32MHz
  306.  
  307. CD-ROM Laufwerk: Mitsumi FX 001 D
  308. Kontroller: Tandem CD+IDE
  309. Filesysteme: TandemCacheCDFS, AmiCDROM
  310.  
  311.  
  312. Entstehungsgeschichte
  313. *********************
  314.  
  315. 1.0 - 20. November 1994
  316.  
  317.     - erste ver÷ffentlichte Version
  318.  
  319. 1.1 - 11. April 1995
  320.  
  321.     - die ixemul.library wird nicht mehr ben÷tigt
  322.     - ein Stack von 4000 Bytes reicht jetzt aus
  323.     - eine kleine ─nderung im HAM-Kodierer bewirkt, da▀ bei einem seitlichen
  324.       Verschieben des Bildes die St÷rungen am linken Rand sehr viel kleiner
  325.       werden
  326.     - besseres und schnelleres ╓ffnen des Bildschirms
  327.     - 16-Bilder-▄bersicht hinzugefⁿgt (Option -0 n)
  328.  
  329.  
  330. Aufruf
  331. ******
  332.  
  333. Wie Du sicher gemerkt hast bietet das Programm bislang nicht sehr viel, es gibt
  334. noch viel zu tun. Meine Zeit ist leider begrenzt. (Ich studiere derzeit Elektro-
  335. technik an der Uni Stuttgart und habe neben der Computerei noch andere Hobbies.)
  336. Aus diesem Grund suche ich weitere Programmierer die bereit sind, mit mir zu-
  337. sammenzuarbeiten sowie Beta-Tester fⁿr die fertigen Programme. Wenn Du mitma-
  338. chen willst dann melde dich bitte. Es wⁿrde mich au▀erdem interessieren, was
  339. sonst noch an Optionen und Verbesserungen des Programms erwⁿnscht ist. Die
  340. ▄bersichtsfunktion ist ja noch ziehmlich primitiv, da lΣ▀t sich noch viel
  341. machen.
  342.  
  343. Alle Zuschriften/Geschenke/Fehlerberichte/VorschlΣge usw. sind an die folgenden
  344. Adressen zu schicken:
  345.  
  346.   Elektronische Post:                               Normale Post:
  347.   *******************                               *************
  348.  
  349.  Guenther@studbox.uni-stuttgart.de                  Gⁿnther R÷hrich
  350.      (Internet EMAIL)                               Lerchenbergstr. 4
  351.                                                     D-73733 Esslingen
  352.  
  353.  
  354. Falls Du innerhalb von drei Wochen keine Antwort auf eine EMAIL bekommst
  355. so versuche es ⁿber die normale Post noch einmal.
  356.  
  357.  
  358. Hier noch die Adresse von Hadmut Danisch, auf dessen Quelltexten dieses
  359. Programm aufbaut.
  360.  
  361. Hadmut Danisch  (danisch@ira.uka.de , will change in future)
  362. E.I.S.S.  (European Institute for System Security)
  363. Universitaet Karlsruhe
  364. Am Fasanengarten 5
  365.  
  366. D-76128 Karlsruhe  
  367.  
  368. Germany
  369.  
  370. FAX: +49 721 696893
  371. Tel./FAX privat: +49 721 607306  (will change in future)
  372.